Le tampon de journalisation du noyau.¶

Le noyau dispose d'un tampon circulaire d'une longueur LOG_BUF_LEN dans lequel il stocke les messages fournis en paramètre à la fonction du noyau printk() (sans tenir compte du niveau de journalisation). Dans les premiers noyaux, LOG_BUF_LEN avait pour valeur 4096 ; à partir du noyau 1.3.54 elle valait 8192 ; à partir du noyau 2.1.113 elle valait 16384; depuis 2.4.23/2.6 la valeur est une option de configuration du noyau. Dans les noyaux récent, la taille peut être demandée avec la commande de type 10.

L'appel syslog(2,buf,len) attend que ce journal soit non vide, puis lit au plus len octets qu'il place dans le tampon buf. Il renvoie le nombre d'octets lus. Les octets lus sont extraits du journal : les informations ne peuvent être lues qu'une seule fois. C'est la fonction exécutée par le noyau quand un programme utilisateur lit /proc/kmsg.

L'appel syslog(3,buf,len) lit les len dernier octets depuis le journal (de manière non destructive). Il ne lira pas plus que ce qui a été écrit dans le tampon depuis la dernière commande de nettoyage (commande « clear ring buffer », qui ne nettoie pas en fait le tampon). Il renvoie le nombre d'octets lus.

L'appel syslog(4,buf,len) effectue la même chose puis vide le tampon (avec la commande « clear ring buffer »).

L'appel syslog(5,dummy,dummy) vide uniquement le tampon (avec la commande « clear ring buffer »). (Dans tous les appels pour lesquels buf ou len est remplacé par « dummy », la valeur du paramètre est ignoré par l'appel).

L'appel syslog(6,dummy,dummy) fixe le niveau de journalisation de la console au minimum, de telle sorte qu'aucun message n'est affiché sur la console.

L'appel syslog(7,dummy,dummy) fixe le niveau de journalisation de la console à la valeur par défaut, de telle sorte que des messages soient affichés sur la console.

L'appel syslog(8,dummy,level) fixe le niveau de journalisation de la console à level, qui doit être un entier compris entre 1 et 8 (inclus). Consultez la section Le niveau de journalisation (loglevel) pour plus de détails.

L'appel syslog(9,dummy,dummy) renvoie le nombre d'octets actuellement disponibles en lecture dans le tampon de journalisation du noyau.

L'appel syslog(10,dummy,dummy) renvoie la taille totale du tampon de journalisation du noyau.

Le niveau de journalisation (loglevel)¶

La routine du noyau printk() n'écrira un message sur la console que si celui-ci a un niveau de journalisation inférieur à la valeur de la variable console_loglevel. Initialement la valeur de cette variable est DEFAULT_CONSOLE_LOGLEVEL (7), mais elle est augmentée à 10 si la ligne de commande du noyau contient le mot « debug », et à 15 si une faute du noyau se produit (en réalité, les valeurs 10 et 15 sont idiotes et n'apportent rien de plus que 8). Cette variable est positionnée (dans l'intervalle 1–8) par l'appel syslog(8,dummy,value). L'appel syslog(type,dummy,dummy) avec type égal à 6 ou 7 la positionne à 1 (seulement les messages kernel panics) ou 7 (tout sauf les messages de débogage), respectivement.

Chaque ligne de texte dans un message a son propre niveau de journalisation. Ce niveau est DEFAULT_MESSAGE_LOGLEVEL - 1 (6) à moins que la ligne ne commence par <d> où d est un chiffre dans l'intervalle 1–7. La signification conventionnelle des niveaux de journalisation est définie dans <linux/kernel.h> comme suit :

#define KERN_EMERG    "<0>"  /* système inutilisable             */
#define KERN_ALERT    "<1>"  /* action à effectuer immédiatement */
#define KERN_CRIT     "<2>"  /* conditions critiques             */
#define KERN_ERR      "<3>"  /* conditions d'erreurs             */
#define KERN_WARNING  "<4>"  /* message d'avertissement          */
#define KERN_NOTICE   "<5>"  /* normal mais significatif         */
#define KERN_INFO     "<6>"  /* informations                     */
#define KERN_DEBUG    "<7>"  /* messages de débugging            */